home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / amok_lha / amok83.lha / TKEd / doc / TKEd.doc.english < prev    next >
Encoding:
Text File  |  1993-08-15  |  73.8 KB  |  2,067 lines
  1.   +-----------------------+
  2.  /                       /|
  3. +-----------------------+ |
  4. | Prg.name : TKEd V1.11 | | 
  5. | Date     : 02.11.1992 | +---------------------------+
  6. |                       |/                           /|
  7. +-----------------------+---------------------------+ |
  8. |     ----  Copyright Tom Kroener                   | |
  9. |    /(c)|            Richard Wagner Str. 40        | |
  10. |   / TKs|            D-6602 Saarbruecken-Dudweiler | |
  11. |  / 1991|            GERMANY                       | |
  12. | --------             +---------+                  | |
  13. |                      | e-mail :|                  | |-----------------+
  14. |          +-----------+         +-----------+      | |                /|
  15. |          | kroener@cs.uni-sb.de (internet) |      | |               / |
  16. |          | thkro@stud.uni-sb.de (internet) |      | |              /  +
  17. |          | T_KROENER@FORUM.ZER (Zerberus)  |      | +             /  /|
  18. |          +----------------------------------+     |/             /  / |
  19. +---------------------------------------------------+-------------+  /  |
  20. | TKEd is NOT public-domain.                                      | /   |
  21. | It may not be used in commercial products without my permission |/    |
  22. +-----------------------------------------------------------------+     |
  23. | TKEd is SHAREWARE. You may copy TKEd and give it to other people|     |
  24. | as long as all files of the directory 'TKEd' are included and   |     |
  25. | no changes were made.                                           |     |
  26. | This version of TKEd allows you to load texts up to a length of |     |
  27. | 9999 Bytes.                                                     |     |
  28. | This should be enough to test TKEd.                             |     |
  29. | You can test TKEd for two or three weeks, but if you want to    |     |
  30. | use TKEd after this time, you have to send me the shareware     |     |
  31. | contribution ($25 (U.S.) or 30 DM)                              |     +
  32. | If you do so , you will become a registered user and you will   |    /|
  33. | get the latest update of TKEd (size of texts only limited       |   / |
  34. | by memory).                                                     |  /  +
  35. | ( If you send me an check, please use DM (Deutsche Mark)!!      | /  /
  36. |                                                                 |/  /
  37. +-----------------------------------------------------------------+  /
  38. | Registered user can get the newest version of TKEd by sending me| /
  39. | $3 (U.S.) or 5 DM.                                              |/
  40. +-----------------------------------------------------------------+
  41. #
  42.  
  43.  
  44.  
  45. See the file 'Changes' for the changes to earlier versions of TKEd !
  46.  
  47.  
  48. ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  49.  
  50. In this documenttext, all of the menus are described in the order of
  51. their appearence.
  52. So it's easy to find the description of the new menus.
  53.  
  54.  
  55. First I want to thank Nico Francois for his great 'reqtools.library'.
  56. ( 'reqtools.library' is © Nico Francois)
  57.  
  58. Many thanks also to Michael Thiel and Stefan Winterstein for testing TKEd 
  59. and discussing errors and features of TKEd, to Jason Trimble for testing
  60. and his suggestions and to Christoph Kirsch for his Lattice-errortool and
  61. his AREXX-scripts and Jörg Tögel and Thomas Schössow for their error-tools!
  62.  
  63.  
  64. **************************************************************************
  65. * Installation:                                                          *
  66. **************************************************************************
  67.  
  68. To test TKEd without full installation start the program 
  69. 'TKEd_QuickInstall' and than start TKEd.
  70.  
  71. To install TKEd on a different disk or on a harddisk, start the program 
  72. 'TKEd_Install' to do this.
  73. If the files 'libs:reqtools.library' and 'libs:powerpacker.library' don't
  74. If the files 'libs:reqtools.library' and 'libs:powerpacker.library' don't
  75. exist, TKEd_Install will copy them to your systems 'libs:'-directory.
  76. After that, TKEd_Install opens a filerequester to choose the directory 
  77. where you want to install TKEd.
  78. Clicking 'OK!' will start copying all the files to the selected
  79. directory.
  80. Clicking 'Forget it' will quit the program.
  81.  
  82. After that, start the program 'TKEd_Assign' from the directory where
  83. you have installed TKEd.
  84. This program assigns the logical directory 'TKEd:' to the current 
  85. directory of TKEd.
  86. You can also add the line 'assign TKEd: dh0:Utilities/TKEd'
  87. to the file 's:startup-sequence' to make this assign everytime you 
  88. boot your Amiga.
  89.  
  90. Instead of dh0:Utilities/TKEd, you have to write your path to the 
  91. directory 'TKEd'
  92.  
  93. After that, you can copy TKEd wherever you want.
  94.  
  95. For users with only one disk-drive:
  96.  
  97. Because TKEd often read from the directory 'TKEd:' the disk where this
  98. directory is assigned to must often be inserted.
  99. If you don't want to do this, make a directory 'ram:TKEd' and copy
  100. the directories 'TKEd:Macros' and 'TKEd:Data' (including the files 
  101. in these directories) to 'ram:TKEd'.
  102. Then go to CLI/Shell and start the command 'assign TKEd: ram:TKEd', and
  103. TKEd will look there for the data-files. ATTENTION: If you change the
  104. preferences and save the preferences to disk, the data is written to 
  105. 'ram:TKEd/TKEd.cfg', so be shure to save this file (TKEd.cfg) to disk
  106. before you switch off your amiga or you will loose the changes.
  107.  
  108.  
  109. ******************
  110. * Possible Errors *
  111. ******************
  112.  
  113. --------------------------------------------------------------------------
  114.  
  115. TKEd won't start correctly:
  116.  
  117. a)  The errormessage
  118.     'ERROR: Directory 'TKEd:Data/' not found!'
  119.     appears:
  120.  
  121.     TKEd needs the directory 'TKEd:Data', where the 4 files 'Menu.d',
  122.     'Menu.e', 'Requests.d' and 'Requests.e' MUST exist.(If one or more
  123.     of this files miss, TKEd won't work correctly)
  124.  
  125. b)  The message 'ERROR: 'TKEd:' not assigned'
  126.     appears:
  127.  
  128.     The logical directory 'TKEd:' must exist.
  129.     Create that directory
  130.  
  131.     from CLI/Shell:
  132.           Enter 'assign TKEd: path', where path is the path to
  133.           your TKEd-directory, e.g. 'assign TKEd: sys:Utilities/TKEd'
  134.  
  135.     from Workbench:
  136.           Start the program 'TKEd_Assign' from the TKEd main directory
  137.  
  138. c)  The message
  139.     'ERROR: Stack < 10000'
  140.     appears:
  141.  
  142.     TKEd needs a stack of 10000 to work correctly. Using less stack,
  143.     TKEd will break sometimes after some minutes.
  144.     If you run TKEd from the CLI or Shell, enter the command
  145.     'stack 10000' before starting TKEd.
  146.  
  147.     If you use your own icon for TKEd (= not the one I have created)
  148.     you have to set this stack yourself: Select the icon with the
  149.     mouse, select the workbench-menu 'Info' and write the value of
  150.     10000 into the field 'Stack'.
  151.     Push the 'Return'-key and save this setting.
  152.  
  153. d)  An Alert shows the message 'missing reqtools.library V38'
  154.     TKEd doesn't find the reqtools.library, or it find an old version
  155.     of it.
  156.     To install the version TKEd needs, use the tool 'Install_TKEd'
  157.     to copy the correct version of the reqtools.library to your 'libs:'
  158.     directory.
  159.     If you want to do this 'by hand', first remove all prgramms using the
  160.     reqtools.library, then copy the reqtools.library from the directory 
  161.     'TKEd:libs' to your 'libs:' directory and execute the 
  162.     command 'avail FLUSH'
  163.  
  164. e)  The menus are empty or not correct
  165.  
  166.     The files 'TKEd:Data/Menu.d' or 'TKEd:Data/Menu.e' don't exist or
  167.     are from other versions of TKEd.
  168.     If possible install TKEd with the installationprogramm, not by hand!
  169.     Use the tool 'Convert' to convert elder configurationfiles.
  170.  
  171. f)  The requesters are empty or not correct
  172.     The files 'TKEd:Data/Requests.d' or 'TKEd:Data/Requests.e' don't exist or
  173.     are from other versions of TKEd.
  174.     If possible install TKEd with the installationprogramm, not by hand!
  175.  
  176. --------------------------------------------------------------------------
  177.     
  178.  
  179. If you prefer to install TKEd 'by hand', you must create a directory 'TKEd'
  180.  
  181. and copy all the files and directories into it.
  182.  
  183. After that, you must copy the 'reqtools.library' and the 
  184.  
  185. 'powerpacker.library' to the 'libs:' directory.
  186.  
  187. The rest (the assigns) : see above !
  188.  
  189.  -----------------------------------------------------------------------
  190. | Important Important Important Important Important Important Important |
  191. |-----------------------------------------------------------------------
  192. |                                                                       |
  193. | 1.   TKEd needs a stack of 10000 to work correctly. Using less stack, |
  194. |      TKEd will break sometimes after some minutes.                    |
  195. |      If you run TKEd from the CLI or Shell, enter the command         |
  196. |      'stack 10000' before starting TKEd.                              |
  197. |      If you use your own icon for TKEd (= not the one I have created) |
  198. |      you have to set this stack yourself: Select the icon with the    |
  199. |      mouse, select the workbench-menu 'Info' and write the value of   |
  200. |      10000 into the field 'Stack'.                                    |
  201. |      Push the 'Return'-key and save this setting.                     |
  202. |                                                                       |
  203. | 2.   Don't use configuration files ('TKEd.cfg') of other versions of  |
  204. |      TKEd, because I have changed some information in it.             |
  205. |      The configuration files of version V1.01 and newer will be       |
  206. |      compatible to future versions. (or if not I will include         |
  207. |      a tool to convert this file)                                     |
  208. |                                                                       |
  209. | 3.   If the menus or requesters are empty, you must install TKEd with |
  210. |      the program 'Install_TKEd' or you must copy 'by hand' the        |
  211. |      directory 'TKEd/Data' to the directory 'TKEd:'.  The files in    |
  212. |      this directory have the data for the menus.                      |
  213. |                                                                       |
  214.  -----------------------------------------------------------------------
  215. | Important Important Important Important Important Important Important |
  216.  -----------------------------------------------------------------------
  217.  
  218.  
  219.  
  220.  
  221. **************************************************************************
  222. * The Keys and the Mouse                                                 *
  223. **************************************************************************
  224.  
  225. -Keys-
  226.  
  227. Some of the menus of TKEd have shortcuts. This means, that you can
  228. also select a menu using the corresponding shortcut.
  229.  
  230. The standard (AmigaDos) way to call shortcuts is to hold down
  231. the right Amiga button and then press the specified button.
  232. (e.g Amiga+l will show the TKEd filerequester)
  233.  
  234. Some other shortcuts (e.g in the menu 'Misc') use the 'Ctrl' button
  235. instead of the right Amiga button.
  236. (e.g. Ctrl+l deletes one line ).
  237.  
  238. To move cursor up or down, use the cursor up/down keys in combination with
  239. the alt-, shift- or the ctrl- key.
  240.  
  241. Cursor up/down          : Moves cursor one line up/down
  242. Alt + cursor up/down    : Moves cursor 4 lines up/down
  243. Shift + cursor up/down  : Moves cursor one page up/down
  244. Ctrl + cursor up/down   : Moves cursor to the beginning/end of a text
  245.  
  246. Cursor left/right         : Moves cursor one character to the left/right
  247. Alt + cursor left/right   : Moves cursor one word to the left/right
  248. Shift + cursor left/right : Moves cursor to the left/right end of the window
  249. Ctrl + cursor left/right  : Moves cursor to the left/right end of a line
  250.  
  251. For moving through the text, you can also use some of the keys of the numeric
  252. keypad in combination with the Shift (or Alt) key.
  253.  
  254. Alt+Home  (Key 7) goes to the beginning of the text.
  255. Alt+End   (Key 1) goes to the end of the text.
  256. Alt+Pg Up (Key 9) goes one page up.
  257. Alt+Pg Dn (Key 3) goes one page down.
  258.  
  259.  
  260. The Help key shows some information about TKEd.
  261.  
  262. The textrequester can also be handled by key-shortcuts: Press the
  263. underscored key and the corresponding gadget will be choosen.
  264. To handle the stringrequester via shortcuts, you have to press first
  265. the right 'Amiga'-key and while holding it down press the underscored
  266. key. (with the 'Amiga'-key, the key will be interpreted as an input to
  267. the text in the stringrequester.
  268.  
  269. You can also use the following shortcuts, if they are not defined
  270. like above via the underscores:
  271.  
  272. 'Y', 'Left amiga +V' or 'Return'-key      : OK
  273. 'N'  'Left amiga +B' 'R' or 'Esc'-key     : Cancel
  274.  
  275. The information-requesters (those with one gadget to click on) can easily be 
  276. closed using e.g. the 'Esc'-key
  277.  
  278.  
  279.  
  280. -Mouse-
  281.  
  282. You can place the cursor  pressing the left mousebutton at the character
  283. you want.
  284. If the cursor position would be right of the end of the line, it will be
  285. placed at the end of the line.
  286.  
  287. If you want to scroll the text up or down, move the mouse to the first or 
  288. to the last two lines of the visible part of the text, hold down the 
  289. left mousebutton and press any key or click the right mousebutton.
  290.  
  291. The mouse is also used to mark parts of the text (see also the Menu
  292. 'Mark Block')
  293.  
  294. **************************************************************************
  295. * Loading a text                                                         *
  296. **************************************************************************
  297.  
  298. There are 4 ways to load a text:
  299.  
  300. 1.  Start TKEd and use the menu 'Load'
  301.  
  302. 2.  Start TKEd from the CLI (or Shell) with the (path-) names of the texts:
  303.     (e.g. 'TKEd s:startup-sequence s:hd-startup' will start TKEd and load 
  304.      the texts 's:startup-sequence' and 's:hd-startup')
  305.      
  306. 3.  Hold down the 'Shift' key, select the icons of the texts, select the 
  307.     icon of TKEd and use the (workbench-) menu 'Open'.
  308.     TKEd will start and load all selected texts.
  309.     
  310. 4.  Select the icon of the text, start the (workbench-) menu 'Info',
  311.     and write the path of TKEd (e.g 'sys:Utilities') into the field
  312.     'Default Tool' .
  313.     After saving this, you can start TKEd by clicking the icon of
  314.     the text and TKEd will load the text.
  315.  
  316. 5.  If you use OS2.04 (or newer), the small window of an 'iconified'
  317.     TKEd (see menu 'Iconify') is an appWindow.
  318.     So you can load a text by dragging the icon of a text on this small 
  319.     window.
  320.  
  321. **************************************************************************
  322. * The Menus                                                              *
  323. **************************************************************************
  324.  
  325. All menus and texts in the requesters are english (default). If you want
  326. german menus and requesters, goto the prefs menu and choose the menu
  327. Language->German.
  328.  
  329. ATTENTION: The english and german texts of the menus and the requesters
  330.            are in the directory 'TKEd:Data'.
  331.            You shouldn't change this texts, because TKEd doesn't check
  332.            the correct length of each text, and a line longer than expected
  333.            can make some trouble while working with TKEd.
  334.            If you want a TKEd using french, spanish or another language:
  335.            Send me a letter (or better a disk) with the correct translations
  336.            of the texts in 'TKEd:Data' for your language.
  337.            With this data, I will add a menu for your language to the
  338.            'Prefs'-menu!
  339.  
  340.            
  341. ***********
  342. * Project ****************************************************************
  343. ***********
  344.  
  345. --------------------------------------------------------------------------  
  346. -New-
  347.   Delete all the text.
  348. -------------------------------------------------------------------------- 
  349. -Open-
  350.   Opens a filerequester to choose the file to load.
  351.   If the text was packed with the PowerPacker, TKEd needs more memory to 
  352.   decrunch it. If you have not enough memory to do this, first decrunch
  353.   the text with the PowerPacker (See Fish 253 for the PD-version of
  354.   the PowerPacker) and then load the decrunched text.
  355.  
  356.   You can also select a file using the arrow-keys (up/down: one line
  357.   up/down; shift+ up/down: one page up/down)
  358.  
  359. --------------------------------------------------------------------------
  360. -Save-
  361.   Saves the text.
  362.   If TKEd finds not enough memory to save the text in the 'normal' mode,
  363.   it saves the text in a slower mode that doesn't need any additional 
  364.   memory.
  365. --------------------------------------------------------------------------
  366. -Save As-
  367.   Opens a filerequester to choose the path and the filename for saving
  368.   the text.
  369. --------------------------------------------------------------------------
  370. -Print-
  371.   Sends the text to the printer.
  372. --------------------------------------------------------------------------
  373. -Insert File-
  374.   Opens a filerequester to choose the file to be inserted in the
  375.   text.
  376.   The file will be inserted between the current line and the previous 
  377.   line .
  378. --------------------------------------------------------------------------
  379. -About-  
  380.   Shows some information about the author and the version of TKEd.
  381.   The name of the current AREXX-port (for the first TKEd 'TKEd.1',
  382.   for the second 'TKEd.2'....) is also showed.
  383.   This is the name you have to use in an AREXX-program to address the 
  384.   AREXX-port of TKEd. (e.g. "address 'TKEd.1'")
  385. --------------------------------------------------------------------------
  386. -Iconify-
  387.   This 'iconifies' TKEd, what means that TKEd closes its screen and its
  388.   window and opens a very small window on the workbench screen.
  389.   So it needs 50.000 Byte less chipmemory.
  390.   If you want to change the position of the icon, move it (like other 
  391.   windows) with your mouse and save the position with the menu 'Prefs Save'.
  392.  
  393.   You can also force this option with the parameter '-i' from CLI or Shell.
  394.   Use the parameter '-i' as the last parameter. (after the filenames
  395.   to load).
  396.  
  397.   Click with the left mousebutton on the closing gagdet or with the
  398.   right mousebutton anywhere on the small window to get the
  399.   'normal' size of TKEd.
  400.  
  401. --------------------------------------------------------------------------
  402. -Sleep-
  403.   This removes the screen and the window of TKEd, but keeps TKEd itself
  404.   ( and all the texts) in memory.
  405.  
  406.   You can invoke TKEd by pessing the keys 'Ctrl' 'Shift' 'Alt' 'Space'
  407.   simultaniously.
  408.   TKEd also awakes when it receives any AREXX-command or when the icon
  409.   of a text was moved on the application window (only OS 2.04 or newer)
  410.   of TKEd.
  411.  
  412.   You can force this option with the parameter '-s' from CLI or Shell.
  413. --------------------------------------------------------------------------
  414. -SaveAll & Quit-
  415.   Saves all modified buffers and quit TKEd.
  416. --------------------------------------------------------------------------
  417. -Save & Quit-
  418.   Saves the text and quit TKEd.
  419. --------------------------------------------------------------------------
  420. -Quit-
  421.   Quit TKEd.
  422. --------------------------------------------------------------------------
  423.  
  424. *********
  425. * Prefs ******************************************************************
  426. *********
  427.  
  428. ATTENTION:  Preferences made under Kickstart 1.2 or 1.3 can be used under
  429.             newer versions (OS 2.04 or newer) without any problems.
  430.             Preferences made under Kickstart 2.04 or newer can cause some
  431.             misterious errors after switching back to Kickstart 1.3 (when
  432.             I choose the screen-mode 'NTSC-Hires' under Kickstart 2.04
  433.             the proportionalgadget of the filerequester don't move under
  434.             kickstart 1.3 when dragging it with the mouse, but after 
  435.             re-saving the preferences and re-loading them everything 
  436.             was alright)
  437.  
  438. --------------------------------------------------------------------------
  439. -Load-
  440.   If you have changed the preferences, you can load the preferences which
  441.   you have saved earlier.
  442.   If you start TKEd, it does this automaticly.
  443.   It looks in the current directory for a file named 'TKEd.cfg', and
  444.   if nothing is found, it looks for it in the directory 'TKEd:'.
  445.   If it has found nothing, TKEd will start with a default
  446.   configuration.
  447. --------------------------------------------------------------------------
  448. -Save-
  449.   Opens a filerequester to save your preferences.
  450.   Default filename is 'TKEd:TKEd.cfg'
  451.   The information saved is:
  452.     -The colors
  453.     -The number of spaces for each tab
  454.     -If auto indent is on or off
  455.     -The information of the 'Backup'- submenus
  456.     -All the data of the User - menus (commands, texts, etc)
  457.     -All the data of the ARexx - menus
  458.     -The shortcuts of the 'Amiga'- menus.
  459.     -The information of the 'Language', 'Screen' and 'Fonts' menus
  460.  
  461.   ATTENTION:
  462.     Never edit a configurationfile of TKEd or the files in the directory 
  463.     'TKEd:Data' 'by hand' using an ASCII- or HEX-editor.
  464.     TKEd espects the format it had saved earlier and doesn't check
  465.     all values in the file.
  466. --------------------------------------------------------------------------
  467. -Default-
  468.     Sets the preferences to the default values and clears all User - menus
  469.     and all ARexx - menus.
  470. --------------------------------------------------------------------------
  471. -Language-
  472.   - English
  473.     English menus and english requesters
  474.  
  475.   - Deutsch
  476.     German menus and german requesters
  477. --------------------------------------------------------------------------
  478. -Screen
  479.   If you use Kickstart 1.2 or 1.3:
  480.     Opens a requester with 5 options:
  481.       - x-Position-
  482.         Sets the horizontal position of the screen (visible only with OS >= 2.0)
  483.         You can also position the screen (like other screens) with the mouse
  484.         and save the position with the menu 'Prefs Save'
  485.     
  486.       - y-Position-
  487.         Sets the vertical position of the screen
  488.         You can also position the screen (like ohter screens) with the mouse
  489.         and save the position with the menu 'Prefs Save'
  490.     
  491.       - Height-
  492.         Sets the width of the screen. TKEd computes a with corresponding
  493.         to the width of the current font
  494.     
  495.       - Width-
  496.         Sets the hight of the screen. TKEd computes a hight corresponding
  497.         to the hight of the current font
  498.     
  499.       - Interlace-
  500.         Switches interlace on/off
  501.  
  502.   If you use OS 2.04 or newer:
  503.     -Opens a 'ScreenmodeRequester' to show all the available screenmodes.
  504.      You can also enter the size and the hieght of the screen and wether
  505.      it shall be an autoscroll-screen or not.
  506.  
  507. --------------------------------------------------------------------------
  508. -Fonts-
  509.   Here you can choose the size of the font
  510.  
  511.   IMPORTANT:  If you want to use the fonts, first start the program
  512.               'Install_Font' to copy the TKEd-fonts to your 'fonts:'
  513.               directory.
  514. --------------------------------------------------------------------------
  515. -Colors-
  516.   Opens a color requester to change the colors of TKEd.
  517. --------------------------------------------------------------------------
  518. -Tab Size-
  519.     How many spaces are printed for one tab ( TKEd handles no tabs).
  520. --------------------------------------------------------------------------
  521. -Folds Start
  522.   Opens a requester to enter the text which TKEd uses to recognize
  523.   the start of a folding (max. 20 characters)
  524. --------------------------------------------------------------------------
  525. -Folds End
  526.   Opens a requester to enter the text which TKEd uses to recognize
  527.   the end of a folding (max. 20 characters)
  528. --------------------------------------------------------------------------
  529. -ShortCuts-
  530.     Gives you the possibility to define your own shortcuts for the
  531.     menus using the standard AmigaDos shortcuts (not the menus with
  532.     the Ctrl-key-shortcuts).
  533.     Shows a textrequester with a string containing the characters
  534.     of the shortcuts of the menus (in the order of their appearance).
  535.     To change a shortcut, delete the character you want to change
  536.     and replace it by the one you like.
  537. --------------------------------------------------------------------------
  538. -Textline-
  539.   Two submenus
  540.  
  541.   -Line length-
  542.     Opens a requester to adjust the max. length of a line.
  543.     If (while writing) the max. length is reached, the cursor will
  544.     automaticly continue writting in the next line.
  545.     The value 255 (=max. Linelength) disables this function
  546.  
  547.   -Wordwrap ON-
  548.     If this menu is marked and the max. linelength is < 255 (see above)
  549.     the last word of the current line will also be moved to the next
  550.     line after reaching the adjusted linelength.
  551. --------------------------------------------------------------------------
  552. -Auto Indent-
  553.     If auto indent is off, each line (after pressing 'RETURN') starts
  554.     at column 1.
  555.     If auto indent is on, each line starts under the first character
  556.     of the previous line, which is not a space.
  557. --------------------------------------------------------------------------
  558. -Set scriptflag-
  559.     IF scriptflag is on, the script-flag ('s') will be set when saving
  560.     a text.
  561.     If you have Kickstart > 1.2 you can start a script without
  562.     using 'execute' if this flag is set.
  563. --------------------------------------------------------------------------
  564. -Open AppWindow-
  565.   If htis menu is on, TKEd opens an 'Application-Window' on the Workbench-
  566.   screen. When you put with the mouse the icon of a text on this window, 
  567.   TKEd loads this text into the next free textbuffer
  568.  
  569. --------------------------------------------------------------------------
  570. -Backup-
  571.   Some functions to specify the way TKEd makes backups:
  572.  
  573.   -Safe Saves-
  574.     IF 'Safe Saves' is on, TKEd will first rename an existing file before
  575.     overwriting it.
  576.     After succesful saving, TKEd will remove the renamed file.
  577.     ATTENTION: This option switches off 'Autobackup' and 'VersionBackup'!
  578.  
  579.   -AutoBackup-
  580.     If 'AutoBackup' is on, TKEd makes a backup of your text (with the ending
  581.     '.bak') while saving a text
  582.     ATTENTION: This option switches off 'Safe Saves' and 'VersionBackup'!
  583.  
  584.   -VersionBackup-
  585.     If 'VersionBackup' is on, TKEd makes different versions of backups
  586.     of your text (with the ending '.bakX') while saving a text.
  587.     X stands for a digit from 0 to 30000.
  588.     Example:If you have a text named 'Letter' and you save it three times,
  589.             the backups 'Letter.bak0', 'Letter.bak1' and 'Letter.bak2'
  590.             will be created.
  591.             The newest version of the text will still have the name 'Letter'.
  592.             The eldest version will have the name 'Letter.bak0'
  593.     ATTENTION: This option switches off 'Autobackup' and 'Safe Saves'!
  594.             
  595.   -Remember with request-
  596.     If this is on, TKEd remembers you after the time entered in the menu
  597.     'Enter time' to save the current text (if modified). If this is not
  598.     on, TKEd saves the text after this time without asking.
  599.  
  600.   -Enter time...-
  601.     Allows you to enter the time after which TKEd remembers you to save the
  602.     text or save the text without requesting.
  603.     
  604.   -Set Extension-
  605.     Opens a requester to enter the extension for the backups.
  606.     (Default: '.bak')
  607. --------------------------------------------------------------------------
  608. -Show Files-
  609.   Opens a requester to enter the name of files you want to see
  610.   in the filerquester.
  611.   Accepts wildcards like '#' and '#?'. You can also use '~' as logical
  612.   not.
  613.   Default: ~(#?.bak#?) ==> show all files without '.bak' in the name.
  614. --------------------------------------------------------------------------
  615. -Search Prefs-
  616.   To submenus for the search/replace function
  617.  
  618.   -Ignore Case-
  619.     Ignore the case of a character (e = E)
  620.  
  621.   -Wildcards-
  622.     You can use '?' in the searchstring as a wildcard.
  623.     Example: If you search the string 'c?me' you will find all words like
  624.              'come', 'came' 'cyme' ...
  625.     Wildcards only works if 'Ignore Case' is switched on.
  626. --------------------------------------------------------------------------
  627.  
  628. **********
  629. * Search *****************************************************************
  630. **********
  631.  
  632. --------------------------------------------------------------------------
  633. -Find-
  634.   Shows a textrequester to enter the text to search for.
  635. --------------------------------------------------------------------------
  636. -Next-
  637.   Goes to the next occurrence of the text to search for.
  638. --------------------------------------------------------------------------
  639. -Previous--
  640.   Goes to the previous  occurrence of the text to search for.
  641. --------------------------------------------------------------------------
  642. -Find/Replace-
  643.   Shows a textrequester to enter the text to search for,
  644.   than another textrequester to enter the text which shall
  645.   replace the searched text.
  646.   After that, for each occurrence of the search text, a requester
  647.   will ask you whether you want to replace the text, whether you
  648.   don't want to replace  it or whether you want to stop the 
  649.   searching/replacing.
  650. --------------------------------------------------------------------------
  651. -Replace next-
  652.   Goes to the next occurrence of the searched text and asks to replace it.
  653. --------------------------------------------------------------------------
  654. -Replace previous-
  655.   Goes to the previous occurrence of the searched text and asks to 
  656.   replace it.
  657.   ATTENTION:  'Replace All' will replace all occurences forward (to the 
  658.               end of the file). Replace all backward is not possible
  659.               (sorry)
  660. --------------------------------------------------------------------------
  661. -Count Occurences-
  662.   Like the menu 'Find', but counts all the occurences in the text.
  663. --------------------------------------------------------------------------
  664. -Matching Bracket-
  665.   If the cursor is positioned over a bracket, this function will locate
  666.   the bracket belonging to this bracket (if there is any).
  667.   Handles (), [] and {}.
  668. --------------------------------------------------------------------------
  669. -Search current char-
  670.   Reads the current character and calls the search-function with this
  671.   character as argument.
  672.   Very usefull to search/replace characters which an Amiga cannot 
  673.   display, e.g. in texts ported from another type of computer.
  674. --------------------------------------------------------------------------
  675. -Goto Mark 0-
  676.    ...
  677.    ...
  678. -Goto Mark 9-
  679.     If you have marked a line (see New Mark) TKEd will move to the
  680.     marked line.
  681.     Very nice if you use the shortcuts 0,1,...8,9.
  682. --------------------------------------------------------------------------
  683. -New Mark-
  684.     Marks the current line with the number you enter in the requester.
  685.     You can set up to 10 different marks by using the numbers 0..9.
  686.     Using a number twice will overwrite the first mark.
  687. --------------------------------------------------------------------------
  688. -Clear Mark-
  689.     Clears the mark you select.    
  690. --------------------------------------------------------------------------
  691.  
  692. *********
  693. * Block ******************************************************************
  694. *********
  695.  
  696. Remark: If you want copy very large blocks, it's better to use 'Save Block' 
  697.         and 'Insert Block' instead of 'Copy' and 'Paste', because
  698.         'Copy' and 'Paste' needs much more time (and memory) than
  699.         'Save Block' and 'Insert Block'.
  700.  
  701.  
  702. Marking with the mouse:
  703.   There are some additional functions available which cannot be used
  704.   via menus:
  705.  
  706.   Clicking at a char 2-times:  Mark word
  707.   Clicking at a char 3-times:  Mark line
  708.   Clicking at a char 4-times:  If the cursor is on a bracket, mark the 
  709.                                text from the bracket to the corresponding 
  710.                                one
  711.  
  712.   You can also mark by pressing the left mousebutton on the first character
  713.   you want to mark, the move the mouse (while pressing the button) down to
  714.   the line and to the last character you want to mark (TKEd will scroll
  715.   the text if the last visible line is reached) and than release the
  716.   mousebutton. The marked region will be displayed inverse!
  717.  
  718. --------------------------------------------------------------------------
  719. -Mark Block-
  720.   Marks the beginning of a block.
  721.   Move the cursor up/down to mark the end of the region.
  722.   (Only movements without 'Alt'- or 'Shift'-key)
  723.   If you don't want to mark all the lines while moving up/down
  724.   press the right 'Alt' key ; these lines will not be marked
  725.   You can also move the cursor to the right to change the left beginning
  726.   of a marked line.
  727. --------------------------------------------------------------------------
  728. -Mark vertical Block-
  729.   ATTENTION: You need this menu only for vertical block with a width
  730.              of 1 (one character).
  731.              All other vertical markings can be made without using
  732.              this menu!
  733.  
  734.   To specify the width of the vertical block, move the mouse from left
  735.   to right will holding down the left mousebutton.
  736.   Move the cursor up/down to mark the end of the region.
  737.  
  738.   You also can mark every line you want (e.g. line 2, 3, 16, 29...) and 
  739.   in  each line a different part  of it (e.g. line 2  : character 1 to 7,
  740.                                               line 5  : character 17 to 97
  741.                                               line 100: charcater 102 to 104...)
  742.   
  743.   if you place the mouse at a different line and mark the line 
  744.   with it (see above).
  745.   This will not remove the marks you have done earlier.
  746.  
  747.   After 'Copy' or 'Cut', the lines are all in an internal block.
  748. --------------------------------------------------------------------------
  749. -Mark all-
  750.   Marks all lines of a text; Current cursor-position marks the left
  751.   end of the block!
  752. --------------------------------------------------------------------------
  753. -Cut Block-
  754.   Cuts all the marked charcters from the text into an internal buffer.
  755. --------------------------------------------------------------------------
  756. -Copy Block-
  757.   Copies all the marked characters into an internal buffer.
  758. --------------------------------------------------------------------------
  759. -Delete Block-
  760.   Deletes all lines of a marked block.
  761.   Could be also realized using 'Cut Block' but needs no extra memory.
  762.   ATTENTION: This function only deletes one marked block. If you have
  763.              marked more parts of a text, this function will do nothing!
  764. --------------------------------------------------------------------------
  765. -Paste Block-
  766.   Inserts a block from the internal buffer to the text.
  767.   Each line of the internal buffer will have a new  line in the text.
  768. --------------------------------------------------------------------------
  769. -Paste vertical Block-
  770.   Inserts a block from the internal buffer into the lines of the text.
  771.   ( no new lines will be created)
  772.   Each line of the internal buffer will be inserted in an existing line
  773.   from the current  position of the cursor.
  774.   If the line would be too long, a part of the line from the internal
  775.   buffer will be lost.
  776.   If 'Paste vertical Blocks' reaches the end of the text, it stops.
  777. --------------------------------------------------------------------------
  778. -Block->-
  779.   Moves each line of a marked block one column to the right.
  780. --------------------------------------------------------------------------
  781. -Block<--
  782.   Moves each line of a marked block one column to the left.
  783.   Lines beginning at column 1 will not be moved.
  784. --------------------------------------------------------------------------
  785. -Unmark Block-
  786.   Unmarks a marked block.
  787. --------------------------------------------------------------------------
  788. ===============
  789. About foldings: With TKEd you ahve the possibility to fold parts of a
  790. =============== text.
  791.                 The folded parts of a text are still in memory, but not 
  792.                 visible on the screen.
  793.                 The last line just before such a folding will be displayed
  794.                 in a different colour.
  795.                 This function makes it much easier to work with large
  796.                 text or programs.
  797.                 For the start and the end of a folded block exist two
  798.                 keywords (see menu 'Prefs'), which can be any kind of
  799.                 text (up to 20 charcters).
  800.                 The default keywords are '(*On*)' and '(*Off*)', so my
  801.                 compile handle it like commends.
  802.                 All text between this two line (including this lines)
  803.                 will be invisible after selecting the menu 'Fold text'.
  804.                 If you have folded large blocks, TKEd will be a little
  805.                 bit slower than normaly, but I think its not to much.
  806.  
  807.     Important:  Functions like 'Search','Replace', 'Cut Blocks' work
  808.                 not correctly with folded blocks, so unfold the parts
  809.                 of a text before you use this functions.
  810.                 All this functions only see the text that you see!                
  811.                 
  812. --------------------------------------------------------------------------
  813. -Fold marked text-
  814.   Inserts the keywords in the first and the last marked line and calls
  815.   the function 'Fold text'.
  816. --------------------------------------------------------------------------
  817. -Fold next-
  818.   Folds the next possible part of a text (if exist)
  819. --------------------------------------------------------------------------
  820. -Unfold next-
  821.   Unfolds the next folded part of a text (if exist)
  822. --------------------------------------------------------------------------
  823. -Fold text-
  824.   Folds all possible parts of a text.
  825. --------------------------------------------------------------------------
  826. -Unfold text-
  827.   Unfold all folded parts of a text.
  828. --------------------------------------------------------------------------
  829. -Insert-
  830.   Opens a filerequester to load a saved block.
  831.   Default name: 't:blk'
  832. --------------------------------------------------------------------------
  833. -Print-
  834.   Sends the internal buffer (see 'Copy' and 'Cut') to the printer.
  835. --------------------------------------------------------------------------
  836. -Save-
  837.   Shows a filerequester to choose the path and the filename for saving
  838.   the internal block. (See also 'Copy' and 'Cut' ).
  839.   Default name:  't:blk'
  840. --------------------------------------------------------------------------
  841.  
  842. ********
  843. * User *******************************************************************
  844. ********
  845.   
  846. --------------------------------------------------------------------------
  847.  
  848. -F1 - F10-
  849.  
  850.   If you don't want to use the mouse, pressing the keys F1 - F10, 
  851.   will also execute the command.
  852.  
  853. --------------------------------------------------------------------------
  854.  
  855. -Select command-
  856.   Opens a filerequester to select the program to execute.
  857.   A path to a program can be saved with the preferences.
  858.  
  859. --------------------------------------------------------------------------
  860.  
  861. -Set Menu:-  (1-10)
  862.   Shows a textrequester which allows you to enter the command that will
  863.   be executed if you select the menu or the function key that belongs 
  864.   to the menu.
  865.   If the command contains [] , TKEd will show a requester ( while 
  866.   excuting the command) and you can enter a text, which will replace
  867.   the []. If the [] are in a text, be sure that one blank is before
  868.   and (if text follows) one blank is after the [].
  869.   Examples : copy [] to ram:
  870.              execute []
  871.              
  872.   If the command contains {}, TKEd will replace the {} by the name of the
  873.   currently loaded file. (be sure to save your text if you have modified
  874.   it).
  875.   About the blanks before or after the {} : see above.
  876.   Examples : copy {} to ram:
  877.              lc -l {}
  878.  
  879.   NEW: If you add a @ followed be a 2-digit number (e.g. {}@12), the last
  880.        12 characters of the name of your text will be deleted.
  881.  
  882.        Examples: 
  883.          Name of the text:   command:           resulting name:
  884.          ------------------------------------------------------
  885.          Hello.c             {}@02     -->      Hello     (.c deleted)
  886.          Scroll.asm          {}@04     -->      Scroll    (.asm deleted)
  887.          Hello.world         {}@07     -->      Hell      (o.world deleted)
  888.  
  889.        There must be no blanks in this sequence, and the number must 
  890.        have 2 digits (no more, no less), otherwise the name of the text
  891.        will not be modified.
  892.        This option is very usefull for programmers who want to start
  893.        a programm after compiling it without entering a new filename or 
  894.        leaving TKEd.
  895.  
  896.  
  897.          
  898.   If the command contains (), TKEd will open a filerequester to make it
  899.   easy to enter the path to a file.
  900.   Example :  muchmore ()
  901.              
  902.   Combinations of {}, () and [] are possible; you can also use each kind
  903.   of bracket several times.
  904.   Examples : copy {} to []
  905.              rename () ()
  906.              lc [] {}
  907.              
  908.   The command text (after inserting the parameters for (),[] or {} )
  909.   can have a length up to 255 characters.
  910.              
  911.   After the textrequester for the command, another one will appear which
  912.   allows you to enter the text which will be shown in the menu.
  913.   This text can have a length up to 18 characters.
  914.   
  915.   If you save your preferences, this data will be saved and reloaded
  916.   everytime you start TKEd.
  917.   
  918.   If you set a menu, existing data will be overwritten, so you
  919.   don't have to clear it first.
  920.   
  921.   To give you the possibility to have a look at the output of an executed
  922.   command, TKEd normaly makes a 'Workbenchtofront' before executing a
  923.          g.SetDrMd (rp, SHORTSET{g.inversvid});
  924. X, 0);
  925. ve his ok to close
  926.   the outputwindow.
  927.   If you don't want to see anythink, add the keyword 'noreq' to the
  928.   command.
  929.   
  930.  
  931. --------------------------------------------------------------------------
  932. -Clear Menu-
  933.   Clears the data of the menu.
  934. --------------------------------------------------------------------------
  935.  
  936. *********
  937. * ARexx ******************************************************************
  938. *********
  939.  
  940. --------------------------------------------------------------------------
  941. -Shift F1 - Shift F10-
  942.  
  943.   If you don't want to use the mouse, pressing the keys Shift F1 - Shift F10
  944.   will also execute the command.
  945. --------------------------------------------------------------------------
  946. -Select command-
  947.   Opens a filerequester to select the AREXX-program to execute.
  948.   A path to a program can be saved with the preferences.
  949. --------------------------------------------------------------------------
  950. -Set Menu:-  (1-10)
  951.   Shows a textrequester which allows you to enter the name of a
  952.   AREXX-program that will be executed if you select the menu or the 
  953.   function key that belongs to the menu.
  954.  
  955.   If the command contains [] , TKEd will show a requester ( while 
  956.   excuting the command) and you can enter a text, which will replace
  957.   the []. If the [] are in a text, be sure that one blank is before
  958.   and (if text follows) one blank is after the [].
  959.   Examples : copy [] to ram:
  960.              execute []
  961.              
  962.   If the command contains {}, TKEd will replace the {} by the name of the
  963.   currently loaded file. (be sure to save your text if you have modified
  964.   it).
  965.   About the blanks before or after the {} : see above.
  966.   Examples : copy {} to ram:
  967.              lc -l {}
  968.  
  969.   NEW: If you add a @ followed be a 2-digit number (e.g. {}@12), the last
  970.        12 characters of the name of your text will be deleted.
  971.  
  972.        Examples: 
  973.          Name of the text:   command:           resulting name:
  974.          ------------------------------------------------------
  975.          Hello.c             {}@02     -->      Hello     (.c deleted)
  976.          Scroll.asm          {}@04     -->      Scroll    (.asm deleted)
  977.          Hello.world         {}@07     -->      Hell      (o.world deleted)
  978.  
  979.        This function could also be done by the called AREXX-program 
  980.        as well, but why remove an existing routine (it was made for the 
  981.        'User'-menus, see section above for details) if it could be 
  982.         of use for someone ?
  983.          
  984.   If the command contains (), TKEd will open a filerequester to make it
  985.   easy to enter the path to a file.
  986.   Example :  muchmore ()
  987.              
  988.   Combinations of {}, () and [] are possible; you can also use each kind
  989.   of bracket several times.
  990.   Examples : 4print.rexx {}
  991.              rexxformat.rexx []
  992.              
  993.   The command text (after inserting the parameters for (),[] or {} )
  994.   can have a length up to 255 characters.
  995.  
  996.   After the textrequester for the command, another one will appear which
  997.   allows you to enter the text which will be shown in the menu.
  998.   This text can have a length up to 18 characters.
  999.   
  1000.   If you save your preferences, this data will be saved and reloaded
  1001.   everytime you start TKEd.
  1002.   
  1003.   If you set a menu, existing data will be overwritten, so you
  1004.   don't have to clear it first.
  1005.  
  1006.   TKEd searches the AREXX-program first in the current directory, then in
  1007.   the directory 'REXX:'.
  1008.  
  1009.   TKEd executes an AREXX-program synchronous (you have to wait until
  1010.   the program has terminated).
  1011.   If you add the keyword 'async' to the command-text, the AREXX-program 
  1012.   will be executed asynchronous, so you can work with
  1013.   TKEd will the AREXX-program is running in the backround.
  1014.   
  1015.   After the AREXX-program has terminated, a requester will appear displaying
  1016.   the results of the AREXX-program.
  1017.   Both results should be 0 (if the program returns no errors)
  1018.  
  1019.   If you don't want this requester, add the keyword 'noreq' to the
  1020.   name of the AREXX-program.
  1021. --------------------------------------------------------------------------
  1022. -Clear Menu-
  1023.   Clears the data of the menu.
  1024. --------------------------------------------------------------------------
  1025.  
  1026. ***********
  1027. * Special ****************************************************************
  1028. ***********
  1029.  
  1030. --------------------------------------------------------------------------
  1031. -Macros-
  1032.   -Start Learning-
  1033.     If you select this, TKEd will ask you the key to assign the macro to.
  1034.     You can use all the keys of your keyboard (except shift and alt).
  1035.     If you use the qualifiers 'shift' or 'alt', you can specify up to
  1036.     3 different macros for each key (key, key+shift, key+alt).
  1037.  
  1038.     After this all actions you make (including keys, menus etc.)
  1039.     will be  recorded by TKEd until you select 'Macros -Stop Learning-'.
  1040.     If you want to include cursor movements which need qualifiers like
  1041.     'shift', 'alt' or 'Ctrl', you must use the corresponding menus
  1042.     to realise this movements.
  1043.     ( e.g. use menu 'End of line' instead of 'shift + cursor right').
  1044.  
  1045.   -Stop Learning-
  1046.     Stops the recording of your actions.
  1047.  
  1048.   -Load Macros-  
  1049.     Loads macros you have saved earlier.
  1050.     TKEd automaticly loads the macros everytime you start it.
  1051.     
  1052.   -Save Macros-
  1053.     Saves all macros to the directory 'TKEd:Macros'.
  1054.     
  1055.   -Clear one Macro-
  1056.     If you push a key which is assigned to a macro, this macro will 
  1057.     be deleted.
  1058.   
  1059.   -Clear all Macros-
  1060.     Clears all the macros.
  1061.     If you don't want to load macros while starting TKEd, 
  1062.     use 'Save macros' after you have cleared.
  1063. ---------------------------------------------------------------------------
  1064. -Undo-
  1065.   -Current line-
  1066.     Restores the current line if modified.
  1067.     ATTENTION: TKEd can remember only the lines after a 'Garbage Collection.
  1068.                Lines modified before a 'Gabage Colleaction; will not be
  1069.                restored.
  1070.                The maximum lines TKEd can remember is 200: If more lines
  1071.                are modified, TKEd will automaticly make a 
  1072.                'Garbage Collection'.
  1073.                A 'Garbage Collection' will also happen if you save a text
  1074.                or if you change the buffer !.
  1075.  
  1076.   -All lines-
  1077.     Restores all modified lines (see above).
  1078.  
  1079.   -Undelete line-
  1080.    If you have deleted a line with the function 'Delete line', this will
  1081.    re-insert the line in the text.
  1082.  
  1083.   -Undelete Block-
  1084.    If you have deleted a block via the menu 'Block... Delete', you can 
  1085.    restore this block with this function.
  1086. ---------------------------------------------------------------------------
  1087. -Mark modified-
  1088.   Marks all modified lines (up to 200, see 'Undo').
  1089.   Helpfull before making 'Undo'
  1090. ---------------------------------------------------------------------------
  1091. -Set current path-
  1092.   With this function, you can change the current directory from the one you 
  1093.   have started TKEd to any other.
  1094.   TKEd will make a 'cd' to the choosen directory.
  1095.  
  1096. ---------------------------------------------------------------------------
  1097. -Helpmode-
  1098.   Switch to help-mode of TKEd: For each menu you select a small help-text
  1099.   will be display. Select this menu again to leave help-mode.
  1100.  
  1101. *********
  1102. * Misc1 *******************************************************************
  1103. *********
  1104.  
  1105. ---------------------------------------------------------------------------
  1106. -Page Up-
  1107.   Moves the cursor one page up.
  1108. ---------------------------------------------------------------------------
  1109. -Page down-
  1110.   Moves the cursor one page down.
  1111. ---------------------------------------------------------------------------
  1112. -Begin of file-
  1113.   Moves the cursor to the very first character position in the file.
  1114. ---------------------------------------------------------------------------
  1115. -End of file-  
  1116.   Moves the cursor to the last page of the file.
  1117. ---------------------------------------------------------------------------
  1118. -Begin of line-
  1119.   Moves the cursor to column 1 of the current line.
  1120. ---------------------------------------------------------------------------
  1121. -End of line-
  1122.   Moves the cursor to the right end of the current line.
  1123. ---------------------------------------------------------------------------
  1124. -Goto line-
  1125.   Shows a requester which allows you to enter the number of the line 
  1126.   to go to.
  1127. ---------------------------------------------------------------------------
  1128. -Next Word-
  1129.   Moves the cursor to the next word.
  1130. ---------------------------------------------------------------------------  
  1131. -Previous Word-
  1132.   Moves the cursor to the previous word.
  1133. ---------------------------------------------------------------------------
  1134.  
  1135. *********
  1136. * Misc2 *******************************************************************
  1137. *********
  1138.   
  1139. ---------------------------------------------------------------------------
  1140. -Delete Word-
  1141.   Removes the rest of the word the cursor is standing on.
  1142. ---------------------------------------------------------------------------
  1143. -Delete line-
  1144.   Removes the current line.
  1145. ---------------------------------------------------------------------------
  1146. -Delete to EOL-
  1147.   Removes the contents of the current line from the
  1148.   cursor position towards the right end of the line. 
  1149. ---------------------------------------------------------------------------
  1150. -JoinLines-
  1151.   Joins the current line with the previous line
  1152. ---------------------------------------------------------------------------
  1153. -Clone line-
  1154.   Makes a copy of the current line
  1155. ---------------------------------------------------------------------------
  1156. -Swap Chars-
  1157.   Swaps the character on which the cursor stands, and the following one.
  1158. ---------------------------------------------------------------------------
  1159. -Swap Case-
  1160.    Changes the character under the cursor from uppercase (lowercase) to
  1161.    lowercase (uppercase).
  1162. ---------------------------------------------------------------------------
  1163.  
  1164. *********
  1165. * Misc3 *******************************************************************
  1166. *********
  1167.   
  1168. -Errors-:
  1169.  
  1170.  It is useful for programmers if an editor has the possibility to display
  1171.  the error-messages of their compilers.
  1172.  Most of the compilers have their own style to show up errors, and I don't
  1173.  know all of them.
  1174.  So I decide to create a (simple) standard for the error-messages, and 
  1175.  TKEd is able to work with it.
  1176.  If your compiler differs from this standard, you have two possibilities:
  1177.  
  1178.  a) Write a small tool which converts the error-messages of your compiler 
  1179.     into a form which can be read by TKEd.
  1180.     Most of the compilers put their messages into an opened console window,
  1181.     so it's easy to redirect them into a file (my tool 'TKA68KErr' executes
  1182.     the command 'A68K > ram:tmperr' and modifies the created file 
  1183.     'ram:tmperr').
  1184.     
  1185.  b) If you don't know how to write such a tool, start your compiler, 
  1186.     redirect the output into a file ( like 'compile > ram:text.err')
  1187.     and send this file and some information about your compiler
  1188.     ( language, version ...) to me.
  1189.     If possible (and if I have enough time to do that), I will write
  1190.     the tool 
  1191.  
  1192. So and now the information about the format TKEd needs: 
  1193.  
  1194. 1.
  1195.   The tool must create a file named 'ram:TKErr' that contains the information
  1196.   for TKEd.
  1197.   
  1198. 2.
  1199.   For each error, the file must contain three lines of information:
  1200.   a)  The linenumber of the error
  1201.   b)  The column of the error
  1202.   c)  The error-message (maximum length: 144 characters)
  1203.  
  1204.   All the information must be normal ascii-text.
  1205.   ( You have to save the linenumber as a string, not as an integer !!)
  1206.   
  1207. 3.
  1208.   Be sure that there are no empty lines between the three lines
  1209.   belonging to one error.
  1210.     
  1211. 4.
  1212.   An example for a text showing three errors:
  1213.   
  1214.   2
  1215.   12
  1216.   Syntax error
  1217.   10
  1218.   1
  1219.   ) expected
  1220.   33
  1221.   5
  1222.   Unexpected end of file
  1223.   
  1224. 5.
  1225.   Be sure that your tool works correctly, because TKEd doesn't control
  1226.   what it reads.
  1227.   If your tool creates an uncorrect file, the error menus will show
  1228.   anything but not the errors.
  1229.   
  1230. 6.
  1231.   The tools should work like normal dos commands, so that it can
  1232.   be started using the 'User'-menus (see above).
  1233.  
  1234. 7.
  1235.   On this disk, I include 5 errortools:
  1236.  
  1237.  
  1238.   Name:               Compiler:         Language:     Author:
  1239.   ------------------------------------------------------------------------
  1240.   TKOberonErr         Oberon V2.0       Oberon        Tom Kroener
  1241.                       V2.0 - V2.14
  1242.   ------------------------------------------------------------------------
  1243.   TKA68KErr           A68K V2.61        Assembler     Tom Kroener
  1244.   ------------------------------------------------------------------------
  1245.   TKaz5_2err          Aztec C 5.2       C             Thomas Schössow
  1246.   ------------------------------------------------------------------------
  1247.   LatticeErrToTKEd    Lattice C V4.0    C             Christoph Kirsch  
  1248.   ------------------------------------------------------------------------
  1249.   Dice_To_TKEd_OS1.3  Dice C            C             Jörg Tögel
  1250.   Dice_To_TKEd_OS2.0
  1251.   ------------------------------------------------------------------------
  1252.  
  1253.  
  1254.   Many thanks to Thomas Schössow for programming the Aztec-C errortool
  1255.   to Christoph Kirsch for the Lattice-C errortool and to Jörg Tögel
  1256.   for the Dice-C errortool.
  1257.  
  1258.  
  1259.   The tools are in the directory 'ErrorTools' and should be used
  1260.   from the usermenus of TKEd.
  1261.   I don't know if these tools work fine with other versions of these 
  1262.   compilers, but I hope so.   
  1263.   
  1264.   If you use TKOberonErr, the program 'OErr' (a tool belonging to the 
  1265.   Oberon-compiler) should be placed in a directory of a path for 
  1266.   AmigaDos commands (e.g. 'sys:', 'c:' or other added paths).
  1267.  
  1268.   If you use TKA68KErr, the program 'A68K' .... (see above)
  1269.  
  1270.   Same procedure for using TKaz5_2err and LatticeErrToTKEd. 
  1271.   (additional documentation from the authors (Thomas Schössow and 
  1272.   Christoph Kirsch) is also included in the directory 
  1273.   'TKEd:ErrorTools/docs/').
  1274.  
  1275. ATTENTION: 
  1276.  
  1277.           a) You must set the compiler option of Aztec C 5.2 to -wq
  1278.              This option forces the compiler to create the file aztec.err,
  1279.              which is used by TKaz5_2err the create the errorfile for
  1280.              TKEd.
  1281.              (See also 'TKEd:ErrorTools/doc/TKaz5_2err.doc' for
  1282.               details).
  1283.  
  1284.           b) Using LatticeErrToTKEd you must start the compiler
  1285.              with the option 'lc >T:Err -L <filename>'
  1286.              An example script (Compile_Lattice) to show how to make
  1287.              this is incuded. 
  1288.              (See also 'TKEd:ErrorTools/doc/LatticeErrToTKEd.doc' for
  1289.               details).
  1290.              
  1291.             
  1292.  
  1293.  
  1294.   If someone programs such a tool for any other compiler and it works
  1295.   fine, I would be happy if he (or she) send it to me.
  1296.   I will publish it with the next version of TKEd. 
  1297.  
  1298.  
  1299. --------------------------------------------------------------------------
  1300. -First Error-
  1301.   Jumps to the first error and displays a requester with the errormessage.
  1302. --------------------------------------------------------------------------
  1303. -Next Error-
  1304.   Jumps to the next error and displays a requester with the errormessage.
  1305. --------------------------------------------------------------------------
  1306. -Enter Ascii-
  1307.   Allows you to enter the ascii value of a character (0-255) 
  1308. --------------------------------------------------------------------------
  1309. -Free Memory-
  1310.   Gives you some information about the available memory.  
  1311. --------------------------------------------------------------------------
  1312. -Remove ANSI-
  1313.   Removes all ANSI-codes. (codes like e.g. )
  1314.  
  1315. **********
  1316. * Buffer *****************************************************************
  1317. **********
  1318.  
  1319. --------------------------------------------------------------------------
  1320. -Goto Buffer-
  1321.   0..9  : Shows the text in buffer 0..9
  1322. --------------------------------------------------------------------------
  1323.  
  1324. *********
  1325. * AREXX ******************************************************************
  1326. *********
  1327.  
  1328. Most of the functions of TKEd can be used by an AREXX program.
  1329. The AREXX-port of TKEd has the name 'TKEd.1' and can be accessed after
  1330. the ARREX-command 'address 'TKEd.1''.
  1331. Attention: The Portname is TKEd.1, not TKED.1 (it's a small 'd')
  1332. For further details consult your ARREX-manual.
  1333.  
  1334. For each TKEd you start, another port with another number as extension
  1335. will be opened (e.g if you start TKEd three times,  the ports
  1336. 'TKEd.1', 'TKEd.2' and 'TKEd.3' will exist).
  1337.  
  1338. The commands are not case  sensitive, therefore 'InsertFile',
  1339. 'INSERTFILE', 'inSErtfILe'... calls all the same function
  1340. of TKEd.
  1341. Some commands need special parameters like 'UP', 'DOWN', 'LEFT',
  1342. 'RIGHT', 'ON', 'OFF', 'FORCE'...
  1343. These parameters are no more (!!) case sensitive since TKEd V1.10, therefore
  1344. UP, uP Up and up are also accepted!
  1345.  
  1346.  
  1347.  
  1348. Normaly, TKEd executes an AREXX-program synchronous (you have to wait
  1349. until the program has terminated).
  1350. If you add the keyword 'async' to the command-text of the menu , the 
  1351. AREXX-program will be executed asynchronous, so you can work with
  1352. TKEd will the AREXX-program is running in the backround.
  1353. If the AREXX-program terminates, a textrequester will show you
  1354. the results.
  1355. If you add the keyword 'noreq' to the command-text of the menu , this
  1356. requester will not appear.
  1357.  
  1358.  
  1359. Now the list of the names, functions, parameters and results of the
  1360. AREXX-functions:
  1361.  
  1362.  
  1363. No.  Name
  1364.      -Function
  1365.      -Parameters
  1366.      -Returnvalues
  1367.  
  1368.  
  1369. This version of TKEd has 109 different AREXX-commands:
  1370.  
  1371.  
  1372. ***************
  1373. *** Project ***
  1374. ***************
  1375.  
  1376.   1. New
  1377.      -Clears all the text 
  1378.      -No parameter
  1379.      -Nothing
  1380.  
  1381.   2: Open
  1382.      -Loads a text
  1383.      -1:Name of the text (No parameter: opens a filerequester)
  1384.      -Name of the text, if successful, else 10
  1385.  
  1386.   3. Save
  1387.      -Saves a text
  1388.      -No parameter
  1389.      -0 if succesful, else 10
  1390.  
  1391.   4. SaveAs
  1392.      -Saves a text with a new name (the loaded text keeps his name)
  1393.      -1:New name of the text
  1394.      -New name, if succesful, else 10
  1395.  
  1396.   5. Print
  1397.      -Sends the text to the printer
  1398.      -Rückgabewer
  1399.      -0 if successful, else 10
  1400.  
  1401.   6. InsertFile
  1402.      -Inserts a text
  1403.      -1:Name of the text
  1404.      -Name of the inserted text, if successful, else 10
  1405.  
  1406.   7. SaveAllAndQuit
  1407.      -Saves all modified buffers and quits TKEd
  1408.      -No parameter
  1409.      -Nothing
  1410.  
  1411.   8. SaveAndQuit
  1412.      -Saves a text and quits TKEd
  1413.      -No parameter
  1414.      -0 if succesful, else 10
  1415.  
  1416.   9. Quit
  1417.      -Quit TKEd
  1418.      -No parameter (FORCE suppresses the Modified requester)
  1419.      -Nothing
  1420.  
  1421. *************
  1422. *** Prefs ***
  1423. *************
  1424.   1. Indent
  1425.      -Switches indent on/off
  1426.      -ON, to switch on, anything else will switch off
  1427.      -Nothing
  1428.           
  1429.   2. AutoBackup
  1430.      -Switches autobackup on/off
  1431.      -ON, to switch on, anything else will switch off
  1432.      -Nothing
  1433.           
  1434.   3. VersionBackup
  1435.      -Switches versionbackup on/off
  1436.      -ON, to switch on, anything else will switch off
  1437.      -Nothing
  1438.  
  1439.   4. SetExtension
  1440.      -Changes the extension of Backups
  1441.      -String with the extension (up to 10 characters)
  1442.      -Nothing
  1443.  
  1444. **************
  1445. *** Search ***
  1446. **************
  1447.  
  1448.   1. Find
  1449.      -Searches a word in the text (forward)
  1450.      -1:word to search for (No parameter: opens a textrequester)
  1451.      -0 if found, else 10
  1452.  
  1453.   2. FindBack
  1454.      -Searches a word in the text (backward)
  1455.      -1:word to search for (No parameter: opens a textrequester)
  1456.      -0 if found, else 10
  1457.  
  1458.   3. FindNext
  1459.      -Searches next occurence of the word
  1460.      -No parameters
  1461.      -0 if found, else 10
  1462.  
  1463.   4. FindPrevious
  1464.      -Searches previous occurence of the word
  1465.      -No parameters
  1466.      -0 if found, else 10
  1467.  
  1468.   5. FindChange
  1469.      -Searches for the next occurence of a word and replaces it with another
  1470.      -1:Word to search for  2:Replacing word (no parameter: opens 
  1471.                                               a textrequester)
  1472.      -0 if possible, else 10
  1473.  
  1474.   6. ChangeNext
  1475.      -Searches for the next occurence of a word and replaces it with another
  1476.                                         one
  1477.      -1:Word to search for  2:Replacing word
  1478.      -0 if possible, else 10
  1479.  
  1480.   7. ChangePrevious
  1481.      -Searches for the previous occurence of a word and replaces it with 
  1482.                                          another one
  1483.      -1:Word to search for  2:Replacing word
  1484.      -0 if possible, else 10
  1485.      
  1486.   8. ChangeAll
  1487.      -Replaces all occurences of a word with another
  1488.      -1:Word to search for   2:Replacing word
  1489.      -Nothing
  1490.  
  1491.   9. CountOccurences
  1492.      -Counts all occurences of a word in a text
  1493.      -1:word
  1494.      -Number of occurences
  1495.      
  1496.  10. MatchingBracket
  1497.      -See menu 'Matching Bracket'
  1498.      -No parameters
  1499.      -0 if matching bracket found, else 10
  1500.    
  1501. *****************
  1502. *** BookMarks ***
  1503. *****************
  1504.   
  1505.   1. GotoBookMark
  1506.      -Goes to the mark
  1507.      -Number of the mark (0..9)
  1508.      -0 if successful, else 10
  1509.      
  1510.   2. SetBookMark
  1511.      -Sets a new mark
  1512.      -Number of the new mark (0..9)
  1513.      -0 if successful, else 10
  1514.      
  1515.   3. ClearBookMark
  1516.      -Clears a mark
  1517.      -Number of the mark (0..9)
  1518.      -0 if successful, else 10
  1519.  
  1520. **************
  1521. *** Blocks ***
  1522. **************
  1523.  
  1524.   See also menu 'Blocks' for more information
  1525.  
  1526.   1. Mark
  1527.      -Marks start of a block
  1528.      -No parameters
  1529.      -Nothing
  1530.  
  1531.   2. MarkVertical1
  1532.      -Marks the left end of a vertical block
  1533.      -Cursorposition of the left end (0..length of the line)
  1534.      -0 if possible, else 10
  1535.  
  1536.   3. MarkVertical2
  1537.      -Marks the right end of a vertical block
  1538.      -Cursorposition of the right end (0..length of the line)
  1539.      -0 if possible, else 10
  1540.  
  1541.   4. MarkAll
  1542.      -Marks all lines (see same menu for details)
  1543.      -No parameters
  1544.      -Nothing
  1545.  
  1546.   5. Cut
  1547.      -See menu 'Cut'
  1548.      -No parameters
  1549.      -Nothing
  1550.      
  1551.   6. Copy
  1552.      -See menu 'Copy'
  1553.      -No parameters
  1554.      -Nothing
  1555.      
  1556.   7. Delete
  1557.      -Deletes all lines of a marked block
  1558.      -No parameters
  1559.      -Nothing
  1560.      
  1561.   8. Paste
  1562.      -See menu 'Paste Block'
  1563.      -No parameters
  1564.      -Nothing
  1565.      
  1566.   9. PasteVertical
  1567.      -See menu 'Paste vertical Block'
  1568.      -No parameters
  1569.      -Nothing
  1570.      
  1571.  10. BlockRight
  1572.      -Moves a marked block one position to the right
  1573.      -No parameters
  1574.      -Nothing
  1575.      
  1576.  11. BlockLeft
  1577.      -Moves a marked block one position to the left
  1578.      -No parameters
  1579.      -Nothing
  1580.      
  1581.  12. UnmarkBlock
  1582.      -Unmarks a block
  1583.      -No parameters
  1584.      -Nothing
  1585.      
  1586.  13. InsertBlock
  1587.      -Opens a filerequester, to load a saved block
  1588.      -No parameters
  1589.      -Nothing
  1590.      
  1591.  14. PrintBlock
  1592.      -Sends a marked block to the printer
  1593.      -No parameters
  1594.      -0 if successful, else 10
  1595.      
  1596.  15. SaveBlock
  1597.      -Opens a filerequester, to save a block
  1598.      -No parameters
  1599.      -Nothing
  1600.  
  1601.  16. Foldmarked
  1602.      -Folds a marked block
  1603.      -No parameters
  1604.      -Nothing
  1605.  
  1606.  17. Fold
  1607.      -Folds all possible parts of a text (seem menu)
  1608.      -No parameters
  1609.      -Nothing
  1610.  
  1611.  18. Unfold
  1612.      -Unfolds all folded text
  1613.      -No parameters
  1614.      -Nothing
  1615.  
  1616.  19. FoldNext
  1617.      -Folds next possible part of a text (see menu)
  1618.      -No parameters
  1619.      -Nothing
  1620.  
  1621.  20. UnfoldNext
  1622.      -Unfolds next folding of a text (see menu)
  1623.      -No parameters
  1624.      -Nothing
  1625.  
  1626.  21. SetFoldOn
  1627.      -Sets the keyword for the beginning of a folding
  1628.      -The neu keyword
  1629.      -Nothing
  1630.  
  1631.  22. SetFoldOff
  1632.      -Sets the keyword for the end of a folding
  1633.      -Neu keyword
  1634.      -Nothing
  1635.  
  1636. *************
  1637. *** Moves ***
  1638. *************
  1639.      
  1640.   1. PreviousPage
  1641.      -Goes to the previous page
  1642.      -No parameters
  1643.      -Nothing
  1644.      
  1645.   2. NextPage
  1646.      -Goes to the next page 
  1647.      -No parameters
  1648.      -Nothing
  1649.      
  1650.   3. BeginOfFile
  1651.      -Goes to the very first character of a text
  1652.      -No parameters
  1653.      -Nothing
  1654.      
  1655.   4. EndOfFile
  1656.      -Goes to the end of the text
  1657.      -No parameters
  1658.      -Nothing
  1659.    
  1660.   5. BeginOfLine
  1661.      -Goes to the very first character of a line
  1662.      -No parameters
  1663.      -Nothing
  1664.      
  1665.   6. EndOfLine
  1666.      -Goes to the right end of a line
  1667.      -No parameters
  1668.      -Nothing
  1669.      
  1670.   7. GotoLine
  1671.      -Goes to a line
  1672.      -Number of the line
  1673.      -0 if successful, else 10
  1674.      
  1675.   8. GotoColumn              Remark: If the line is shorter the the column
  1676.      -Goes to a column        you want to place the cursor at, spaces will be
  1677.      -Number of the column    inserted at the end of the line
  1678.      -0 if successful, else 10
  1679.       
  1680.   9. NextWord
  1681.      -Goes to the next word
  1682.      -No parameters
  1683.      -Nothing
  1684.  
  1685.  10. PreviousWord
  1686.      -Goes to the previous word
  1687.      -No parameters
  1688.      -Nothing
  1689.  
  1690.  11. Cursor
  1691.      -Moves the cursor up/down/left/right
  1692.      -UP, DOWN, LEFT or RIGHT (use capital letters)
  1693.      -Nothing
  1694.             
  1695.  12. Line
  1696.      -Moves cursor the specified number of lines up/down
  1697.      -Number of lines (e.g. 23, -45, +6)
  1698.      -10, if the cursor reaches the beginning/end of the text, else 0
  1699.      
  1700.  13. Column
  1701.      -Moves cursor the specified number of characters to the lft/right
  1702.      -Number of characters (e.g. 23, -45, +6)
  1703.      -10, if the cursor reaches the beginning/end of the line, else 0
  1704.  
  1705.  14. GotoByte
  1706.      -Jumps to the specified byte (= character). The very first byte 
  1707.       is no.=0.
  1708.       If the specified byte is beyond the end of the text, the TKEd jumps 
  1709.       to the very last byte in the text.
  1710.       (Remember: The not visible 'Return'-character at the end of each 
  1711.        line is also one byte)
  1712.      -Number of the byte ( >=0 )
  1713.      -0 if ok, else 10
  1714.  
  1715. **************
  1716. *** Delete ***
  1717. **************
  1718.      
  1719.   1. DeleteWord
  1720.      -Deletes the word under the cursor
  1721.      -No parameters
  1722.      -Nothing
  1723.      
  1724.   2. DeleteLine
  1725.      -Deletes the current line
  1726.      -No parameters
  1727.      -Nothing
  1728.      
  1729.   3. DeleteToEOL
  1730.      -Deletes the current line from the position of the cursor to the end
  1731.                                                        of the line
  1732.      -No parameters
  1733.      -Nothing
  1734.  
  1735. **************
  1736. *** Errors ***
  1737. **************
  1738.  
  1739.   1. FirstError
  1740.      -Displays the first error of an errorfile
  1741.      -If parameter = PROMPT : Shows a requester with the errormessage
  1742.      -Errormessage (if exist), else 10
  1743.      
  1744.   2. NextError
  1745.      -Displays the next error of an errorfile
  1746.      -If parameter = PROMPT : Shows a requester with the errormessage
  1747.      -Errormessage (if exist), else 10
  1748.    
  1749. ************
  1750. *** Keys ***
  1751. ************
  1752.   
  1753.   1. FunctionKey
  1754.      -Executes one of the user-/ARexx-menus
  1755.      -Number 0 to 19 (F1=0 ... F10=9, Shift-F1=10 ... Shift-F10 = 19)
  1756.      -Nothing
  1757.  
  1758.   2. MakeReturn
  1759.      -Same as pressing the 'return'-key
  1760.      -No parameters
  1761.      -Nothing
  1762.  
  1763.   3. del
  1764.      -Same as pressing the 'Del'-key
  1765.      -No parameters
  1766.      -Nothing
  1767.  
  1768.   4. backspace
  1769.      -Same as pressing the '<-' -key
  1770.      -No parameters
  1771.      -Nothing
  1772.  
  1773. ***************
  1774. *** Buffers ***
  1775. ***************
  1776.  
  1777.   1. GotoBuffer
  1778.      -Shows the text in the specified buffer
  1779.      -Number of the buffer (0 to 9)
  1780.      -0 if any text is loaded, 5 if no text is loaded, 10 if error
  1781.  
  1782.   2. GetBufferNr
  1783.      -Returns the number of the current buffer
  1784.      -No parameters
  1785.      -Number of the buffer
  1786.  
  1787.   3. FindBuffer
  1788.      -Searches a buffer and goes to it (if found)
  1789.      -Name of the buffer (not case sensitive); if no name is specified,
  1790.       TKEd switches to the next free buffer (if exist any)
  1791.      -Number of the buffer (0..9) if found; 10 if not found
  1792.  
  1793. ***********************
  1794. *** Get information ***
  1795. ***********************
  1796.      
  1797.   1. GetLineNr
  1798.      -Returns the number of the current line
  1799.      -No parameters
  1800.      -Number of the line
  1801.      
  1802.   2. GetColumnNr
  1803.      -Returns the number of the current column
  1804.      -No parameters
  1805.      -Number of the column
  1806.      
  1807.   3. GetChar
  1808.      -Returns the character at the cursor-position
  1809.      -No parameters
  1810.      -1 character
  1811.  
  1812.   4. IsChar
  1813.      -Returns whether the cursor stands on a character or not
  1814.      -No parameters
  1815.      -0 if character (a..z, A..Z), else 10
  1816.      
  1817.   5. GetLine
  1818.      -Returns the text of the current line
  1819.      -No parameters
  1820.      -Text of the line
  1821.  
  1822.   6. GetLineLen
  1823.      -Returns the length of the current line
  1824.      -No parameters
  1825.      Length of the line
  1826.  
  1827.   7. LastLine
  1828.      -Returns the linenumber of the very last line of a text
  1829.      -No parameters
  1830.      -Number of the last line
  1831.     
  1832.   8. GetFileName
  1833.      -Returns the name of the loaded text (without path)
  1834.      -No parameters
  1835.      -Name of the text
  1836.  
  1837.   9. GetPathName
  1838.      -Returns the path to the loaded text (without name)
  1839.      -No parameters
  1840.      -Path of the text
  1841.  
  1842.  10. GetFullPathName
  1843.      -Returns path and name of the loaded text
  1844.      -No parameters
  1845.      -Full pathname of the text
  1846.  
  1847.  11. FirstMarkedLine
  1848.      -Returns the number of the first marked line
  1849.      -No parameters
  1850.      -Number of the first marked line or -1 if nothing is marked
  1851.  
  1852.  12. Language
  1853.      -Returns the language used in TKEd
  1854.      -No parameters
  1855.      -'GERMAN' if german language is used and 'ENGLISH' if english language
  1856.                is used 
  1857.  
  1858. *********************
  1859. *** Write to text ***
  1860. *********************
  1861.     
  1862.   1. WriteChar
  1863.      -Writes down one character
  1864.      -1 character
  1865.      -0 if successful, else 10
  1866.      
  1867.   2. WriteString
  1868.      -Writes down a string
  1869.      -String (up to 255 characters long)
  1870.      -0 if successful, else 10
  1871.  
  1872. *******************************
  1873. *** Interaction to the user ***
  1874. *******************************
  1875.  
  1876.   1. Request1
  1877.      -Opens a requester to show a text to the user
  1878.      -Text of the requester. If the keyword 'TKED' is in this text,
  1879.       the requester will appear in the window of TKEd.
  1880.       If not, the requester will appear in the the activ window. 
  1881.      -Nothing
  1882.       
  1883.   2. Request2
  1884.      -Opens a requester with two gadgets to show a text to the user
  1885.      -Text of the requester. If the keyword 'TKED' is in this text,
  1886.       the requester will appear in the window of TKEd.
  1887.       If not, the requester will appear in the activ window. 
  1888.      -0 after clcking 'OK', 10 after clicking 'Cancel
  1889.  
  1890.   3. GetNumber
  1891.      -Opens a requester to enter a number
  1892.      -Text at the top of the requester
  1893.      -Number or 0 if the requester was canceled
  1894.  
  1895.   4. GetString
  1896.      -Opens a requester to enter a test. (up to 255 characters)
  1897.      -Text at the top of the requester|Default Text
  1898.       e.g. Enter a text|Tom Kroener
  1899.      -Text
  1900.  
  1901.   5. Beep
  1902.      -Makes a 'beep' to signal the user 
  1903.      -No parameters
  1904.      -Nothing
  1905.  
  1906.   6. DisplayBeep
  1907.      -Makes a 'Displaybeep' to signal the user
  1908.      -No parameters
  1909.      -Nothing
  1910.  
  1911.   7. MakeTitle
  1912.      -Display a text (for a short time) in the titlebar of TKEd
  1913.      -Text to display
  1914.      -Nothing
  1915.  
  1916.  
  1917. ************
  1918. *** Misc ***
  1919. ************
  1920.  
  1921.   1. JoinLines
  1922.      -Joins the current line with the previous line
  1923.      -No parameters
  1924.      -Nothing 
  1925.  
  1926.   2. CloneLine
  1927.      -Makes a dublicate of the current line
  1928.      -No paramters
  1929.      -Nothing
  1930.  
  1931.   3. SwapChars
  1932.      -Swaps to characters
  1933.      -No parameters
  1934.      -Nothing
  1935.      
  1936.   4. SwapCase
  1937.      -See same menu
  1938.      -No parameters
  1939.      -Nothing
  1940.      
  1941.   5. UpperCase
  1942.      -Changes the character under the cursor from lowercase to uppercase
  1943.      -No parameters
  1944.      -Nothing
  1945.  
  1946.   6. LowerCase
  1947.      -Changes the character under the cursor from uppercase to lowercase
  1948.      -No parameters
  1949.      -Nothing
  1950.  
  1951.   7. EnterAscii
  1952.      -Writes down the ASCII-character belonging to the number
  1953.      -ASCII-number of the character  (0 < number < 256)
  1954.      -0 if successful, else 10
  1955.      
  1956.   8. TKEdtoFront
  1957.      -Pushes the screen of TKEd to the front
  1958.      -No parameters
  1959.      -Nothing
  1960.      
  1961.   9. TKEdtoBack
  1962.      -Pushes the screen of TKEd to the back
  1963.      -No parameters
  1964.      -Nothing
  1965.  
  1966.  10. WBtoFront
  1967.      -Pushes the workbenchscreen to the front
  1968.      -No parameters
  1969.      -0 if possible, else 10
  1970.      
  1971.  11. ReName
  1972.      -Renames the text
  1973.      -New name for the text
  1974.      -Nothing
  1975.  
  1976.  12. Delay
  1977.      -Waits for the specified time
  1978.      -Time to wait in 1/50 seconds (e.g.'Delay 50' will wait for one second)
  1979.      -Nothing
  1980.  
  1981.  13. Sleep
  1982.      -Makes TKEd 'sleeping' (See menu 'Sleep'). The ARREX-program waits as
  1983.       long as TKEd is sleeping; this is an easy way to make one AREXX-
  1984.       program to wait for another: The second AREXX-program only needs to
  1985.       send any AREXX-command to TKEd to 'wake up' TKEd and the first
  1986.       program will continue.
  1987.      -No parameters
  1988.      -Nothing
  1989.  
  1990.  14. StripAnsi
  1991.      -Remove all ANSI-codes from the current cursor position to the
  1992.       end of the text
  1993.      -No parameters
  1994.      -Nothing
  1995.      
  1996.      
  1997. Using AREXX, you can realise functions you miss: See the programs in
  1998. the directory 'TKEd:REXX' to have examples how to do this.
  1999.  
  2000.  
  2001. If you have installed AREXX and the command has the name 'rexx:makenumber',
  2002. you can start this program from the 'ARexx'-menus using the 
  2003. command 'makenumber'.
  2004.  
  2005. **************************************************************************
  2006. * Other informations                                                     *
  2007. **************************************************************************
  2008.  
  2009. a)  TKEd is reentrant and the pure-bit is set.
  2010.     So it's easy to make TKEd resident.
  2011.  
  2012. b)  TKEd can load and decrunch texts packed with the powerpacker.
  2013.     TKEd decrunches the text to the ram disk ( 'ram:' ) and loads it.
  2014.     Be sure to have the ram.device in your 'devs:' directory and the
  2015.     ram.handler in your 'l:' directory.   
  2016.     If you have not enough memory to do this, first decrunch
  2017.     the text with the PowerPacker (See Fish 253 for the PD-version of
  2018.     the PowerPacker) and then load the decrunched text.
  2019.    
  2020.    
  2021. c)  Most of the tests of my compiler for NIL-pointers, wrong types, ranges 
  2022.     and so on are still part of TKEd.
  2023.     This reduces the speed of TKEd, but often prevents to see the Guru.
  2024.     If TKEd crashes, a message will appear:
  2025.     If this happens, I would be happy if you would send me a letter with 
  2026.     this message and the function of TKEd which you have called just before
  2027.     error .
  2028.     If you are a registered user I will send you a disk with the newest
  2029.     version of TKEd; if not, I hope that you find the next published version
  2030.     of TKEd (having less errors) good enough to send me the share.
  2031.  
  2032. d)  If you miss a feature, write to me (you need not to be a registered
  2033.     user to do this).
  2034.     I will try to add the mostly asked features to TKEd.
  2035.  
  2036. e)  Nobody is perfect. If I have written 'press right button' and
  2037.     nothing happens, keep cool an try the right one.
  2038.     I often say 'right' when I mean 'left'.
  2039.  
  2040. f)  If you want a TKEd using french, spanish or another language:
  2041.     Send me a letter (or better a disk) with the correct translations
  2042.     of the texts in 'TKEd:Data' for your language.
  2043.     With this data, I will add a menu for your language to the
  2044.     'Prefs'-menu!
  2045.     
  2046. **************************************************************************
  2047.  
  2048.  
  2049. If you have criticism, suggestions, errortools, good AREXX-scripts,
  2050. trouble with TKEd, error reports, gifts or something else 
  2051. write to
  2052.  
  2053. Tom Kroener
  2054. Richard Wagner Str. 40
  2055. D-6602 SB-Dudweiler
  2056. GERMANY  
  2057.  
  2058.                             --- Tom
  2059.     
  2060.     
  2061.     
  2062.  
  2063.  
  2064.  
  2065.   
  2066.  
  2067.